home *** CD-ROM | disk | FTP | other *** search
/ Super PC 35 / Super PC 35 (Shareware).iso / spc / UTIL / READ602 / BRUCE602.DOC next >
Encoding:
Text File  |  1996-02-18  |  32.4 KB  |  612 lines

  1. BRUCE602.DOC                         1                         Revised: 02/18/96
  2.  
  3. --------------------------------------------------------------------------------
  4.                               Contact information
  5.  
  6. For the following routines:  AV,  BFIND,  COPSINCE,  DATES,  DIRCOMP,  DIRTOTAL,
  7. FILL, FIXTEXT, FORTUNE, HTMSTRIP, PAGINATE,  READINIT,  READMAKE-created  files,
  8. and TXTABLE:
  9.  
  10.                 Bruce Guthrie
  11.                 Wayne Software
  12.                 113 Sheffield St.
  13.                 Silver Spring, MD 20910
  14.  
  15.                 fax: (301) 588-8986
  16.                 e-mail: bguthrie@nmaa.org
  17.                 http://hjs.geol.uib.no/guthrie/
  18.  
  19. For the following routines:  CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ,
  20. and READY:
  21.  
  22.                 Bruce Guthrie
  23.                 Room H-4885
  24.                 U.S. Dept of Commerce/ESA/STAT-USA
  25.                 Washington, DC 20230
  26.  
  27.                 fax: (202) 482-2164
  28.                 voice: (202) 482-3234
  29.  
  30.                 e-mail: bguthrie@doc.gov
  31.  
  32. Foreign users:  Please provide  an  Internet-reachable  e-mail  address  in  all
  33. correspondence if you have any hope of getting a reply!  Internet e-mail is  the
  34. preferred method of contact for all  other  users  as  well.   America  On-Line,
  35. CompuServe, and Prodigy all offer Internet e-mail access so get with it!
  36.  
  37. Since these programs are typically "freeware"  (with  the  exception  of  people
  38. trying to make money from them instead of me), they generate maybe $100/year  in
  39. revenue for me.  As such, my ability to afford  wonderful  customer  support  is
  40. somewhat restricted.   Please  do  not  leave  messages  saying  "Call  me  long
  41. distance".  Also, please be specific  about  what  problems  you  encounter  and
  42. include command-line inputs as well as any control  or  INI  files  that  you're
  43. using.
  44.  
  45. The "production" releases of these programs are posted  directly  by  me  (Bruce
  46. Guthrie, the author) on the Simtel ftp site at ftp.coast.net.  More  information
  47. about locations at this site is provided later.  People are encouraged to upload
  48. them to bulletin board systems but I do not upload them to BBS's myself.
  49.  
  50. Standard disclaimer in this society:  Wayne Software disclaims all warranties as
  51. to this software, whether express or implied, including without  limitation  any
  52. implied  warranties  of  merchantability,  fitness  for  a  particular  purpose,
  53. functionality, data integrity or protection.
  54.  
  55.  
  56. BRUCE602.DOC                         2                         Revised: 02/18/96
  57.  
  58. --------------------------------------------------------------------------------
  59.                                   Introduction
  60.  
  61. This documentation provides some overview information on a number of  utilities.
  62. All  programs  described  herein  were  written  by  Bruce  Guthrie.   Most  are
  63. distributed with a Wayne Software copyright.  Others were written for  the  U.S.
  64. Department of Commerce.  All are free for use provided relevant documentation is
  65. kept with the programs, no changes are made to the  programs  or  documentation,
  66. and they are not bundled with commercial programs or charged for separately.
  67.  
  68. CHANGE, CONVERT, FILUPDAT, ISAMFIND/ISAMMAKE, READ, and READY are excluded  from
  69. the commercial-packaging restriction.  These programs  are  owned  by  the  U.S.
  70. Department of Commerce and may be re-distributed without restriction.
  71.  
  72. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP,  DIRTOTAL,  FILL,
  73. FIXTEXT,  FORTUNE,  HTMSTRIP,  PAGINATE,  READINIT,  or  TXTABLE  in  commercial
  74. packages other than shareware/freeware collections must pay a  $50  registration
  75. fee to "Wayne Software" at the following address.   READMAKE-created  files  are
  76. also subject to this limitation.  I don't expect to make any  money  from  these
  77. utilities but I don't want others to sell them instead.
  78.  
  79. This collection of utilities were compiled using Microsoft's  Visual  BASIC  for
  80. DOS 1.0 compiler.  Thomas G. Hanlin III's excellent  PBClone  routines,  release
  81. 2.3, provided additional functionality.  Since Tom has dropped support  for  his
  82. PBClone routines, some things will are simply not possible for me to do so don't
  83. push!  The basic routines should be able to be maintained indefinitely  as  long
  84. as DOS continues to exist; we'll see.  I keep thinking that I  should  be  doing
  85. Windows programming but it's hard to get psyched up for that when you  think  of
  86. Windows as a computer virus.
  87.  
  88. Documentation provided in appropriate ZIP files:
  89.  * routine.DOC: Each utility is separately described in a like-named *.DOC file.
  90.  * FILE_ID.DIZ: Standard Description In Zip file.
  91.  * BRUCEymm.DOC: This file serves to summarize all  of  the  various  utilities.
  92.      The "ymm" indicates the release date in  year/month  format.   "601"  means
  93.      1996, first month (Jan 1996).
  94.  * BRUCEINI.DOC: Most of the routines have defaults that can  altered  by  using
  95.      initialization files (inifiles).   These  are  referenced  in  the  regular
  96.      documentation and further described here.  (One thing about *.INI files; if
  97.      you don't have one, it's in your interests to specify the "/-I"  parameter.
  98.      Otherwise, the program searches your entire DOS path looking for the file.)
  99.  * BRUCEHEX.DOC: Many of the routines allow you to enter  parameters  as  either
  100.      hexadecimal  or  decimal  strings.   This  is  referenced  in  the  regular
  101.      documentation and further described here.
  102.  
  103.      All program documentation was created  using  a  text  editor  (PE2).   The
  104.      PAGINATE command (see below) was  used  to  justify  the  text  and  create
  105.      titles, page breaks, and (where provided) indexes.
  106.  
  107. Beta  testers  and  suggestions  are  always   appreciated.    Contact   me   at
  108. bguthrie@nmaa.org  Note that all beta releases are done via e-mail  so  if  your
  109. gateway can't handle some pretty big mail attachments,  you  definitely  do  NOT
  110. want to be a beta tester for me!  Modifications that are not of  mainstream  use
  111. can be contracted for.
  112.  
  113.  
  114. BRUCE602.DOC                         3                         Revised: 02/18/96
  115.  
  116. --------------------------------------------------------------------------------
  117.                             The programs themselves
  118.  
  119. The utilities are uploaded with a ZIP name that includes the year and  month  of
  120. the release in a "ymm" format ("602" is the February 1996 version).   The  files
  121. are posted directly by the author to two places.  The following Web site has the
  122. current versions of *all* programs:
  123.  
  124.                 http://hjs.geol.uib.no/guthrie/
  125.  
  126. Thanks to Hans Schrader for the Web site!  Major releases are also posted on the
  127. Simtel archives at  ftp.coast.net  (Web  to  http://www.coast.net/SimTel  site.)
  128. Users are encouraged to post the files on bulletin boards and such  but,  again,
  129. the author directly posts only to these sites.
  130.  
  131. If you're using a version of the programs that's more  than  a  year  old,  it's
  132. almost always the case that there's  a  newer  version.   Please  check  for  an
  133. update.  If you can receive binary attachments, contact me at  bguthrie@nmaa.org
  134. for free updates.  Alternatively, send $10 made out to "Wayne Software"  to  the
  135. Wayne Software address above and I'll send you everything on diskette.  (If  you
  136. need anything other than 3.5" high density, specify that too please.)
  137.  
  138. The versions of each program posted on SimTel are documented  below  along  with
  139. the directory information for  this  site.   The  *current*  versions  of  *all*
  140. programs are posted on the Web site in Norway.
  141.  
  142. This listing is current as of the February 1996 (602) release.
  143.  
  144. SimTel/msdos/arcutil/
  145. av602.zip       Archive View: Free ZIP etc directory viewer
  146.  
  147.    AV.EXE:  Archive directory viewer.  Presents list of files in  archive  (ZIP,
  148.    ARC, etc) and lets you sort as desired.  Also allows resetting  of  the  file
  149.    date based on the archive's contents.
  150.  
  151. SimTel/msdos/textutil/
  152. bfind511.zip    Boolean FIND command (BFIND BEGIN & END)
  153.  
  154.    BFIND.EXE:  Allows Boolean-type FIND requests.  For example,  find  any  line
  155.    with one string AND another one, or any line  with  one  string  OR  another.
  156.    Also allows wildcarded input file names.
  157.  
  158. SimTel/msdos/textutil/
  159. chang510.zip    Change strings in text files
  160.  
  161.    CHANGE.EXE:  Processes change commands in files.  Files can be  of  any  size
  162.    and type (e.g.  binary or text) and are  processed  quickly.   Up  to  thirty
  163.    change commands can be processed in a single pass.  Also provides ability  to
  164.    remove trailing spaces from text files.
  165.  
  166. SimTel/msdos/spredsht/
  167. convr601.zip    Convert dBase, ASCII-delim, fixed, 1-2-3
  168.  
  169.    CONVERT.EXE:  Converts between data  formats:   FROM  dBase,  ASCII-delimited
  170.    (typically commas between fields and quotes around strings), and fixed  field
  171.    TO Lotus WKS, ASCII-delimited, dBase, and fixed field.
  172.  
  173.  
  174. BRUCE602.DOC                         4                         Revised: 02/18/96
  175.  
  176. SimTel/msdos/dirutil/
  177. cops601.zip     Copies files modified since given date
  178.  
  179.    COPSINCE.EXE:  Copies all files modified since a given date.  Primarily  used
  180.    for making sure you have a back-up of files and also to copy updated programs
  181.    to another place.  Lets you define your own groupings of files if desired.
  182.  
  183. SimTel/msdos/batutil/
  184. dates601.zip    Warns you in advance of birthdays etc
  185.  
  186.    DATES.EXE:  Program that warns you in advance when an event like a  birthday,
  187.    anniversary, or holiday is coming up.   The  idea  is  to  give  you  advance
  188.    warning so you can send a card or get out of town in time.
  189.  
  190. SimTel/msdos/dirutil/
  191. dirco601.zip    Updates files based on source directory
  192.  
  193.    DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds  ability
  194.    to delete extra files in the destination subdirectory, copy hidden and system
  195.    files, and prepare a report showing inconsistencies.  Is frequently  used  by
  196.    network administrators to update workstation files.
  197.  
  198. SimTel/msdos/dirutil/
  199. dirto602.zip    Directory lister and totaller
  200.  
  201.    DIRTOTAL.EXE:  Prepares  report  showing  files  in  subdirectory  or  drive.
  202.    Allows restricting search based on date, size,  attributes,  etc.   Works  on
  203.    networked and CD-ROM drives.   Produces  more  formalized  report  than  some
  204.    utilities do.  Also allows you to look for duplicate file names.
  205.  
  206. SimTel/msdos/diskutil/
  207. fill602.zip     Stuffs as many files as possible on disk
  208.  
  209.    FILL.EXE:  Program designed to move files off to floppy diskettes, taking the
  210.    biggest files first and skipping those that won't fit.  Also provides  option
  211.    of splitting large files up, creating a status report, and other features.
  212.  
  213. SimTel/msdos/dirutil/
  214. filup601.zip    Copy updated files based on a control list
  215.  
  216.    FILUPDAT.EXE:  Program which compares a selected list of files  in  a  source
  217.    path against those in another path and copies those that have  been  updated.
  218.    Similar to DOS' REPLACE command  but  works  from  a  stored  list  of  files
  219.    (controlled updates) and can handle any number of directories.
  220.  
  221. SimTel/msdos/textutil/
  222. fixtx602.zip    Translate text file characters en masse
  223.  
  224.    FIXTEXT.EXE:  Program which applies  a  user-definable  character-translation
  225.    table to a text file.  Can allow you to convert graphics characters to  their
  226.    text equivalents, lowercase letters to uppercase letter, etc.   Can  also  be
  227.    used to translate DOS text files to Mac or Unix text files  and  vice  versa.
  228.    Can also expand tabs, remove trailing spaces, and remove backspaces.
  229.  
  230.  
  231. BRUCE602.DOC                         5                         Revised: 02/18/96
  232.  
  233. SimTel/msdos/batutil/
  234. fortn510.zip    Fine-tunes DOS FOR command w/options
  235.  
  236.    FORTUNE.EXE:  A tuner-upper for the DOS FOR command.  Generates a batch  file
  237.    which does all those wildcard things you wished FOR could do  (like  "FORTUNE
  238.    IN (*.BAS) DO RENAME %A %2*.*" to remove parts of file names).  Lets  you  do
  239.    all sorts of things including  distinguishing  file  name  roots  from  their
  240.    extensions as well as incrementing file names by specified values.
  241.  
  242. SimTel/msdos/textutil/
  243. htmst602.zip    Reprocesses HTML pages for humans to read
  244.  
  245.    HTMSTRIP.EXE:  Goes  through  downloaded  pages  from  the  Web  and  removes
  246.    embedded HTML commands.  Reflows paragraphs and tries to  make  it  basically
  247.    readable.
  248.  
  249. SimTel/msdos/textutil/
  250. isamf509.zip    Full-text searching help desk documents
  251.  
  252.    ISAMFIND.EXE and ISAMMAKE.EXE:  Programs that work in conjunction to  provide
  253.    full-text searching of text files.  This is useful for helpdesk  applications
  254.    and other functions where you want to  search  for  files  and  retrieve  the
  255.    "best" document that matches your search criteria.
  256.  
  257. SimTel/msdos/textutil/
  258. pagin601.zip    Paginates text (indexes, sorts, tables)
  259.  
  260.    PAGINATE.EXE:  Reformats text files with embedded formatting codes.   Handles
  261.    things like titles, footers, indexes, alignment,  justification,  multicolumn
  262.    listings,  etc.   Also  provides  support  for  embedding  tabular  data   in
  263.    ASCII-delimited or dBase formats which can be embedded and/or sorted in  your
  264.    reports.
  265.  
  266. SimTel/msdos/textutil/
  267. read602.zip     Free viewer, also make any text self-viewing
  268.  
  269.    READ.EXE, READY.EXE, READINIT.EXE,  and  READMAKE.EXE:   Text  file  browsing
  270.    utilities.  READ--Supports marking, copying text, reading Unix and  Mac  text
  271.    files, etc.  Handles files of 16,000 lines or less  (approx  800,000  bytes).
  272.    READY--truncates or wraps lines over 255 characters  in  length  but  handles
  273.    files of an unlimited number of lines.  READMAKE--Takes  an  ASCII-text  file
  274.    and makes it self-viewable (using a READ clone).
  275.  
  276. SimTel/msdos/textutil/
  277. txtab602.zip    Generates text tables
  278.  
  279.    TXTABLE.EXE:  Program to generate text tables.  Input file can be either:
  280.     ┌───────────────────┬──────────────────────────────────────────────────┐
  281.     │ One line per cell │ Reasonably easy to switch columns around         │
  282.     ├───────────────────┼──────────────────────────────────────────────────┤
  283.     │ Pseudo-HTML code  │ Why bother learning *two* ways of making tables? │
  284.     └───────────────────┴──────────────────────────────────────────────────┘
  285.    Includes quickie utility that dumps WordPerfect file into something this  can
  286.    read so you can try to convert WordPerfect tables to text.
  287.  
  288.  
  289. BRUCE602.DOC                         6                         Revised: 02/18/96
  290.  
  291. --------------------------------------------------------------------------------
  292.                                 Revision history
  293.  
  294. Detailed revision histories for the programs are only maintained  for  the  last
  295. three releases.  After that, you get the major revision summaries only  for  the
  296. next three releases or so.  In any  case,  if  your  version  of  any  of  these
  297. programs is more than a year old, your version is definitely obsolete.  Hop onto
  298. the Web or e-mail me or something and get the new version!
  299.  
  300. -------------- (full detail; revisions made 1 to 3 months ago)
  301. Release 96/02:
  302.  
  303.   AV:  Added help screen (F1) and the ability to Ctrl-PgUp or Ctrl-PgDn  through
  304.   up to 500 archives.  Require Y/N input if press Escape  or  Quit  now.   Added
  305.   colors to the /? help panel.  [Replaces av509.zip]
  306.  
  307.   DIRTOTAL:  Added sorting by file extension.  [Replaces dirto510.zip]
  308.  
  309.   FILL:  Added an estimation of the number of diskettes left  to  go  (shows  up
  310.   whenever you're prompted to insert the next diskette).  [Replaces fill601.zip]
  311.  
  312.   FIXTEXT:  Fixed a problem with switching to/from  CR-LF-CR/LF.   Sigh.   Never
  313.   make changes right before you release something...  Also fixed a bug in  /TEXT
  314.   vs /-TEXT.  Added /EOF and /-EOF.  [Replaces fixtx601.zip]
  315.  
  316.   HTMSTRIP:  Tables are now handled by the  program.   The  table-handling  code
  317.   from the TXTABLE program was ported over.   Added  parameters:  /BORDER=c  and
  318.   /BUFF=n.   Dropped  parameters:  /TABLES,  /-TABLES,  and  /TAB=n.   [Replaces
  319.   htmst601.zip]
  320.  
  321.   READ and READMAKE:  Fixed an error that showed up if  you  used  *.INI  files.
  322.   [Replaces read601.zip]
  323.  
  324.   READY:  Added /FILTER=filename parameter (needed to read some more native word
  325.   processing files and got tired of seeing π and ╙ instead of double  quotes  in
  326.   someone's Mac file.  Added /TEXT option  to  stop  the  program  from  loading
  327.   anything it considered text only (it examines the  first  thousand  bytes  for
  328.   non-ASCII characters).  [Replaces read601.zip]
  329.  
  330.   TXTABLE:  Internally, was significantly recoded  in  order  for  the  code  to
  331.   portable to the HTMSTRIP command.   Added  the  ability  to  support  imbedded
  332.   pseudo-HTML code as well in addition to the original input format.  The former
  333.   allows you to  have  more  than  one  table  in  the  input  file.   [Replaces
  334.   txtab601.zip]
  335.  
  336. Release 96/01:
  337.  
  338.   All routines:  There are advantages to a month of snow and vacations.  On  the
  339.   one hand, it gives you time to test out  things  and  consider  those  changes
  340.   you've been thinking about for so long.  It also gives you plenty of  time  to
  341.   hop on the Web and get new ideas and such.  As a result, some of this  month's
  342.   releases include some major changes and  enhancements.   There's  even  a  new
  343.   routine or two. On the other hand, the number of people available to  actually
  344.   test these changes drops considerably (especially when much of  the  goverment
  345.   was on furlough). Let's hope for the best!
  346.  
  347.   In the meantime, my Internet provider has actually got e-mail working  so  I'm
  348.   happy.  The bguthrie@nmaa.org address can be used for any of  these  routines.
  349.  
  350. BRUCE602.DOC                         7                         Revised: 02/18/96
  351.  
  352.   I've only been using this site for a week or so but, again, I'm hoping for the
  353.   best!
  354.  
  355.   All routines:  I got bored  putting  the  same  sections  in  every  piece  of
  356.   documentation I write.  The section on INI files has been expanded  and  moved
  357.   into a separate file called BRUCEINI.DOC which is included in the  appropriate
  358.   ZIP files.  Also, for  the  routines  that  support  hexadecimal  and  decimal
  359.   equivalent strings, the  hexadecimal/decimal  table  has  been  moved  into  a
  360.   separate file called BRUCEHEX.DOC which is also included  in  the  appropriate
  361.   ZIP files. This doesn't reduce the size  of  the  ZIP  at  all  (increases  it
  362.   actually) but it should reduce space if you use more than one of my programs.
  363.  
  364.   All routines:  Finally dropped support for the CONFIGWS.EXE settings from  all
  365.   routines.
  366.  
  367.   CONVERT:  Added cell filters (only write out the record based on the value  of
  368.   one or more cells in the record).  This is especially useful with  files  like
  369.   the SimTel archive file listing (ftp.coast.net, subdirectory  SimTel/filedocs,
  370.   filename simindex.zip) since it allows you to, for  example,  only  get  those
  371.   files that were added since 951001.  (Remember, the field-definition file  for
  372.   this file is included in the  CONVERT  archive.)  Modified  program  to  allow
  373.   assignments to be made to created variables within a record.  Fixed a bug with
  374.   /GAP=n  specification  (didn't  work  unless   you   asked   for   an   OUTDEF
  375.   specification). Added the ability to read Unix or Mac  text  files.   Switched
  376.   default from /TO WKS to /TO FIXED.  [Replaces convr512.zip]
  377.  
  378.   COPSINCE:  Mostly documentation update.  Some of what was specified there  was
  379.   wrong and didn't  match  what  the  routine  could  do  now.   Parameters  are
  380.   described a bit better now.  [Replaces cops509.zip]
  381.  
  382.   DATES:  Added /?&H parameter.
  383.  
  384.   DIRCOMP:  Fixed a bug  with  /ALL  (didn't  copy  if  files  were  identical).
  385.   Changed the default to write no  report  ("/-F")  and  added  a  "/F"  option.
  386.   Reformatted the output to the screen quite a bit.  Fixed up colors again (some
  387.   how, I deleted all of the code I added last time on this) and added  "/-COLOR"
  388.   option since I really  hate  white  on  blue  (sorry!).   Added  a  number  of
  389.   parameters that are the reverse of what's up there (e.g. /UPDATE and /-UPDATE)
  390.   so INI files would work better and the screen display would make  more  sense.
  391.   Changed file counters to double integer instead of single so you can use it on
  392.   systems with like 2 million files instead of just  15,000-ish.   (Don't  ask.)
  393.   [Replaces dirco512.zip]
  394.  
  395.   FILL:  Minor change to make /LAST apply to /SPLIT disks  as  well.   [Replaces
  396.   fill512.zip]
  397.  
  398.   FILUPDAT:  Added support for *.INI files.  Allowed ctlfile  to  be  passed  in
  399.   with /Cctlfile  parm  so  it  could  appear  in  the  *.INI  file.   [Replaces
  400.   filup510.zip]
  401.  
  402.   FIXTEXT:  Added a /BINARY option which lets you strip binary codes from things
  403.   like  native  WordPerfect  files.   If  anyone  comes   up   with   a   useful
  404.   character-translation table for this, please let me know!  Didn't  realize  it
  405.   during testing but "/TO CRLF" type requests had to be in  uppercase  to  work;
  406.   changed that.  Also added a queue that keeps track of which files have already
  407.   been processed so if you're using wildcards with /REPLACE, you won't  get  the
  408.   same file processed multiple times.  [Replaces fixtx512.zip]
  409.  
  410.  
  411. BRUCE602.DOC                         8                         Revised: 02/18/96
  412.  
  413.   HTMSTRIP:  Decided  to  simplify  the  programming  considerably  by  removing
  414.   support for the PAGINATE  command.   All  parameters  that  were  specific  to
  415.   PAGINATE have been dropped.  Dropped support for  /-WRAP  option  (who'd  want
  416.   that anyway?). Made /WIDTH a synonym for  /LENGTH;  changed  documentation  to
  417.   make  /LENGTH  the  standard  wording.   Switched  default  to  /-SYMBOLS  and
  418.   /-WARNINGS.  More debugging in <PRE>...</PRE> blocks.  Now  handles  <DD>  and
  419.   <OPTION> HTML commands.  Changed the  way  the  warning  and  other  on-screen
  420.   messages were displayed; should be a bit clearer now.  Titles of pages are now
  421.   centered.  Allowed for &...; replacements using the more  relaxed  rules  that
  422.   seem prevalent today in Web pages (" " is the standard but both " " and
  423.   "&32;" are being used).   Added  a  few  replacements  that  I  couldn't  find
  424.   documented anywhere; where else are people getting these  from?   Tables  come
  425.   out better now but they're certainly not perfect.  Eventually,  HTMSTRIP  will
  426.   handle the HTML  3.0  tables  directly  and  the  TXTABLE  program  (which  is
  427.   introduced this time) is a first shot at figuring  out  how  to  handle  them.
  428.   (TXTABLE doesn't directly handle HTML documents but  there's  an  undocumented
  429.   /TEST parameter in HTMSTRIP which generates an output file that TXTABLE  reads
  430.   and another undocumented /HTML parameter in TXTABLE which processes them;  the
  431.   combination shows you how I might be handling them in the future.) I processed
  432.   over a thousand Web pages with this command in January alone; it's amazing how
  433.   many  variations  (and  errors)  there  are   in   these   things!   [Replaces
  434.   htmst512.zip]
  435.  
  436.   PAGINATE:  Coded to make WIDTH a synonym for LENGTH; changed documentation  to
  437.   make LENGTH the standard wording.  Added ERRORLEVEL return  codes.   [Replaces
  438.   pagin512.zip]
  439.  
  440.   READ, READMAKE:  Changed program so F3/F9 would find next  line  with  string,
  441.   not necessarily the next  occurence  of  the  string  itself.   Tabs  are  now
  442.   expanded  on  display.   This  causes  the  maximum  line  length   to   shift
  443.   periodically but that's life.  F3/F9 now work  consistently  when  you  change
  444.   documents with Ctrl-PgUp  and  Ctrl-PgDn.   Added  /?&H  parameter.  [Replaces
  445.   read509.zip]
  446.  
  447.   READINIT:  Fixed a bug with passing in parms into  the  routine.   Added  /?&H
  448.   parameter. [part of read601.zip]
  449.  
  450.   READY:  Allowed the  program  to  handle  files  with  lines  of  132  or  255
  451.   characters. Added parameters /80, /132, and /255 to let you specify which  one
  452.   to use but otherwise the program reads the first 6000 bytes of  the  file  and
  453.   determines the maximum line length from there.  Results in a bigger  temporary
  454.   file of course. Added the  various  horizontal  scrolling  key  options--Right
  455.   Arrow, Left Arrow, Tab, Shift-Tab, Ctrl-Right, Ctrl-Left.  Modified  /INDENT=n
  456.   parameter to allow you to specify an indent string indicator with the  ability
  457.   to include decimal and hexadecimal codes.  Fixed  up  a  bug  with  /INDENT=0.
  458.   Allowed you to indent the first line  of  a  continued  line  instead  of  the
  459.   subsequent lines by passing  in  /INDENT=-n.   Added  /?&H  to  show  you  the
  460.   hexadecimal and decimal values.  Added  support  for  binary  files  including
  461.   native format word processing files; new options for this  include:   /BINARY,
  462.   /FILTER, /EOL=str.  This allows you to read something like  a  Microsoft  Word
  463.   for Windows document and write it out as a text file; requires a lot of manual
  464.   work to create something usuable from the result but it's something.   Default
  465.   switched to /WRAP.  Added /?&H parameter. [part of read601.zip]
  466.  
  467.   TXTABLE:  New program.  I'm not really sure what will become of this  program.
  468.   Originally, it was designed as a way of processing WordPerfect tables which no
  469.   one seems to be able to write out correctly when you do the TextOut  function.
  470.   I also figured it would help in terms of figuring out how to handle  HTML  3.0
  471.  
  472. BRUCE602.DOC                         9                         Revised: 02/18/96
  473.  
  474.   tables in the HTMSTRIP command.  The  ZIP  includes  a  (hopefully  temporary)
  475.   program called XWPTABLE.EXE which retrieves cells from WordPerfect 5.1 for DOS
  476.   files and writes them out in a format that TXTABLE can read and process.  [New
  477.   program; replaces nothing]
  478.  
  479. Release 95/12:
  480.  
  481.   All routines:  This release is  dedicated  to  the  comic  strip  "Calvin  and
  482.   Hobbes" which is about to disappear from 2,400 newspapers  across  the  world.
  483.   I'm not alone in knowing that I'll miss that strip,  the  only  really  bright
  484.   spot in comics these days.  (Being a nerd, I also  enjoy  "Dilbert"  but  that
  485.   strip never brings out the wonder of life, just the basic horrors of the  work
  486.   place.) Now I'll never know the horrors that someone like Calvin will face  on
  487.   his first date.  (Can you imagine how he would  have  perceived  of  something
  488.   like a bra strap?) It was also nice to know someone who was socially less  fit
  489.   than I was even while his cohort was so damned suave.
  490.  
  491.   Some routines may not work with Windows95's new  directory  format.   I'm  not
  492.   crazy enough to have installed the 1.0 version of an  operating  system  so  I
  493.   don't know but you might keep it in mind.
  494.  
  495.   CONVERT:  Now allows you to read fixed-fixed files which contain  lines  which
  496.   do not end with CR/LF.  These are typical of files created on a  mainframe  or
  497.   copied from a tape.  The routine SPLITREC was  previously  included  with  the
  498.   routine to get around this but that's being dropped with  this  release.   Now
  499.   allow the input and output file types to be the same; useful if  you  want  to
  500.   just reformat some existing data.  New  parameters:  /SCAN=n  (allows  you  to
  501.   specify the number of records to scan for maximum field widths if /FROM  ASCII
  502.   and /-INDEF are specified) and /GAP=n (adds n-characters to each output  field
  503.   if /-INDEF and /TO FIXED are  specified  so  columns  will  be  spaced  out  a
  504.   little).  Added a field-definition  file  (SIMIBM.DEF)  for  the  SimTel  file
  505.   archives.  Cleaned up the output field-definition file a little.  Changed  the
  506.   field-definition file to make the decimal count and output length optional.
  507.  
  508.   DIRCOMP:  Now allow for up to 10 file exclusions.
  509.  
  510.   FILL:  Added a message for "last disk of /MULTI set" if you're writing to  the
  511.   last of a multi-disk set.  Also /LAST and /-LAST option indicator  to  control
  512.   whether it shows up or not.
  513.  
  514.   FIXTEXT:  Added automatic detection of  input  text  format  (lines  end  with
  515.   CR/LF, CR alone, or LF alone).  Makes  the  program  ideal  for  automatically
  516.   converting all files in a given subdirectory from, say, Unix text files to DOS
  517.   text files. This became necessary as I started downloading more files from the
  518.   Web.  Dropped a number of parameters related to this:  /CRLF,  /CR,  and  /LF.
  519.   Fixed-length input files now require /n parameter instead of both  /-LINE  and
  520.   /WIDTH=n parameters.  Fixed-length output files now require  /TO  n  parameter
  521.   instead  of  both  /TO  -LINE  and  /WIDTH=n  parameters.   Dropped   /WIDTH=n
  522.   parameter.  Now allow the output files to be created in another  subdirectory,
  523.   allowing you to convert a whole bunch of files from something  one  place  and
  524.   create them to another subdirectory.  Changed default to be not to  produce  a
  525.   *.BAD file (/-F).
  526.  
  527.   HTMSTRIP:  Decided HTMSTRIP did a decent enough job handling  the  files  that
  528.   the second PAGINATE pass was no longer necessary so /-PAG (don't use PAGINATE)
  529.   is now the default.  Split HTMSTRIP out from the PAGINATE  ZIP  for  the  same
  530.   reason. Added parameters:  /SPACES, /-SPACES, /TAB=n,  /WARNINGS,  /-WARNINGS,
  531.   /RULE=string.  Added support for HTML pages with Centering,  whether  PAGINATE
  532.  
  533. BRUCE602.DOC                         10                        Revised: 02/18/96
  534.  
  535.   is used or not.  Added ability to replace [Image], [Input],  and  [Link]  with
  536.   your own strings.  Lots of bug fixes.  Added lots of additional codes  in  the
  537.   HTMSTRIP.INI file as specified by Dave  Raggett's  HyperText  Markup  Language
  538.   Specification Version 3.0 draft  (03/28/95).   Lots  of  debugging  on  tables
  539.   including handling (in a way)  tables  embedded  in  tables.   Dropped  /FORCE
  540.   parameter.  Added automatic detection and skipping of GIF, JPEG, and BMP files
  541.   so you can process all the files in your cache subdirectory.
  542.  
  543.   PAGINATE:  New /Linitfile parameter (allows you to replace characters from the
  544.   input file when you write  out  the  file).   New  marker  commands:   -TITLE,
  545.   -FOOTER, -HEADER  (turn  off  existing  titles,  footers,  and  headers),  and
  546.   PAGEEJECT=string. Dropped HTML and -HTML market commands since HTMSTRIP should
  547.   really be  used  instead.   Removed  HTMSTRIP  from  the  ZIP  and  separately
  548.   distributing.  Fixed following bugs:  (1) reduced chance of blow up if totally
  549.   whacked ASCII-delimited files, (2) the RIGHT marker command didn't  work,  and
  550.   (3) fixed a bug which kept writing out  Alt-255  characters  for  things  like
  551.   bulleted items; they are now replaced by  regular  spaces  on  output.   Other
  552.   changes:  (1) Got tired of it automatically generating an extra page (complete
  553.   with title) if you just happened to write to the last  line  of  the  previous
  554.   page so made titles  conditional  on  actually  printing  something  afterward
  555.   (unless EJECT FRONT or EJECT BACK is specified).  (2) Am now providing a  file
  556.   PAGNOASC.INI which removes graphic and other possibly non-printable characters
  557.   on output (see /Linitfile parameter).  (3) The  program  now  removes  leading
  558.   spaces from input sections  in  which  "#  CENTER"  is  in  effect;  this  way
  559.   re-centering can be successfully done.
  560.  
  561. -------------- (kind of terse; revisions made 4 to 6 months ago)
  562. Release 95/11:
  563.  
  564.   BFIND:  Added /EMPTY and /-EMPTY options.  Program now reads non-DOS files.
  565.  
  566.   DIRCOMP:  Fixed a bug with the /-F option.
  567.  
  568.   HTMSTRIP:  Added automatic wrapping based on the desired line  length  so  you
  569.   don't have to use PAGINATE.
  570.  
  571.   READY:  Added /LOAD option.
  572.  
  573. Release 95/10:
  574.  
  575.   BFIND:  Added wildcard and @listfile support to program.
  576.  
  577.   CHANGE:  Added @listfile support to program.
  578.  
  579.   CONVERT:  Fixed a bug with writing to DBF files when you wanted  input  fields
  580.   dropped.
  581.  
  582.   FILUPDAT:  Added /ERROR and /-ERROR parameters.
  583.  
  584.   FIXTEXT:  Added wildcard and @listfile input file name support to program.
  585.  
  586.   HTMSTRIP:  New command.  Is included in the archive with the PAGINATE command.
  587.  
  588.   PAGINATE:   Added  support  for   wildcards   and   @listfile   specification.
  589.   Additional command line parms:  /EXT=.xxx, /PAUSE, and  /-PAUSE.   New  marker
  590.   commands:  SUM, BREAK, INDENTER=string, FLAG=string, and RULE=string.
  591.  
  592. Release 95/09:
  593.  
  594. BRUCE602.DOC                         11                        Revised: 02/18/96
  595.  
  596.  
  597.   All  programs:   Switched  documentation  to  include   page   headers,   full
  598.   justification, etc using PAGINATE command.
  599.  
  600.   CHANGE:  Added wildcard specs for the input file.
  601.  
  602.   ISAMFIND/ISAMMAKE:  Lots of changes (parms added and dropped).  Added  support
  603.   for combining files to be processed into a single file.
  604.  
  605.   PAGINATE:  Added support for the output file name in titles, footers, etc.
  606.  
  607.   READ:  Fixed some problems with searching.
  608.  
  609.   READY:  Added line processing ranges.
  610.  
  611. 
  612.